home *** CD-ROM | disk | FTP | other *** search
/ Speccy ClassiX 1998 / Speccy ClassiX 98.iso / amiga_system / the_aminet / dev / basic / gtboxconv.lha / gtboxconv / docs / italiano / GtBoxConv.doc < prev    next >
Text File  |  1995-10-24  |  10KB  |  221 lines
  1. ----------------------------------------------------
  2. GadToolsBox Converter V3 - Written By Fabio Rotondo.
  3. ----------------------------------------------------
  4.  
  5. ATTENZIONE:
  6. -----------
  7. Il  software  viene  fornito  "cos'∞  com'Φ",  l'autore non pu≥ essere ritenuto
  8. colpevole  per  eventuali  danni  hardware  o  software derivanti l'utilizzo di
  9. questo  programma.  L'autore non pu≥ inoltre risultare colpevole di anomalie di
  10. funzionamento  del  sistema  operativo  o  della  perdita  di dati attribuibili
  11. dall'utilizzo  di  questo  programma.   Usate questo programma a vostro rischio
  12. personale.
  13.  
  14. COPYRIGHT:
  15. ----------
  16. Questo programma Φ (C)Copyright 1995 Fabio Rotondo.
  17. Sebbene  il  programma sia quindi proprietario, potete liberamente utilizzare e
  18. distribuire  questo  programma  senza  per≥  chiedere  soldi  per la copia.  Il
  19. programma Φ GiftWare, significa che se lo trovate utile e lo apprezzate, potete
  20. spedire  un  "regalo"  di qualsiasi tipo (dischetti, soldi, software scritto da
  21. voi, cartoline ecc...) all'autore:
  22.  
  23.     Fabio Rotondo
  24.     C.so Vercelli 9
  25.     28100 Novara
  26.     ITALY
  27.     Tel. 0321 - 459676
  28.  
  29. E-Mail: fsoft@intercom.it
  30.  
  31. Spero che apprezziate i miei sforzi ed utilizziate il mio programma.
  32.  
  33. DISTRIBUZIONE:
  34. --------------
  35. Il   programma   Φ   liberamente  distribuibile.   Potete  quindi  copiarlo  ed
  36. installarvelo  su  Hard Disk senza violare alcuna legge.  Per la distribuzione,
  37. comunque, dovete rispettare le seguenti regole:
  38.  
  39.   1 - Non modificare in alcun modo il file di archivio col quale viene
  40.       distribuito il programma.
  41.   2 - Non aggiungere, cancellare o modificare alcun file dell'archivio.
  42.   3 - Nel caso desideriate tradurre il programma o il manuale in altre
  43.       lingue, dovrete prima richiedere l'autorizzazione scritta dell'autore.
  44.   4 - Nel caso desideriate inserire il programma in una raccolta di programmi
  45.       free/shareware per la vendita dovrete richiedere l'autorizzazione
  46.       dell'autore. Gradirei anche ricevere una copia della raccolta.
  47.   5 - Se utilizzerete il programma per creare del software PD o Commerciale
  48.       gradirei comparire nei Greetings e, se possibile, ricevere una copia
  49.       del programma.
  50.   6 - Il programma Φ GiftWare: speditemi un regalino...
  51.  
  52. Se rispetterete questi punti, allora andremo sempre d'accordo.
  53.  
  54.  
  55. INTRODUZIONE:
  56. -------------
  57. GadToolsBox  Converter  V3.02 Φ  un  programma  che  permette  di convertire le
  58. interfacce create con GadToolsBox in codice per Blitz II.
  59. Il  suo  utilizzo  Φ  molto  semplice  ed  immediato.   Se sapete come funziona
  60. GadToolsBox,  saprete  anche  utilizzare  GadToolsBox  Converter (da ora in poi
  61. semplicemente  GTConv).   Questo  programma  Φ  nato  come  piccolo software di
  62. conversione  personale  e si Φ evoluto nel tempo fino alla versione 3.0, quella
  63. che  adesso  avete  per  le  mani.   Molte  modifiche  sono  state apportate al
  64. programma  originale  e  molte  altre  cose cambieranno nelle prossime versioni
  65. (sempre ammessa l'esistenza delle prossime versioni...  ;) 
  66. Inizialmente,  quando in Blitz II implementarono la gadtools.library, non c'era
  67. alcun   modo   per   scrivere  delle  interfacce  decenti,  allora  mi  misi  a
  68. giocherellare  con  GadToolsBox di Jan van der Baard e capii che, con un po' di
  69. lavoro, sarei riuscito a creare un convertitore da GTBox a Blitz II.  Ed eccolo
  70. qui.   Le  caratteristiche  pi∙ importanti della nuova versione (3.0) che avete
  71. tra le mani sono:
  72.  
  73.   - Possibilitα di definire il numero di BevelBox, Testi e di Menu.
  74.   - Possibilitα di definire il numero di GTList e di Window da generare.
  75.   - Auto allocamento della memoria per quanto riguarda la creazione dei
  76.     gadgets.
  77.   - Utilizzo delle costanti che vengono definite in GTBox per la numerazione
  78.     dei gadgets. (Questo semplifica e migliora la creazione del codice :)
  79.   - Nuova versione pi∙ funzionale dell'handler dei gadgets che pu≥ venire
  80.     creato. (Vedi pi∙ avanti)
  81.   - Nuova metodo di creazione delle finestre: adesso i requester ReqTools
  82.     si aprono SEMPRE sulla finestra corretta.
  83.   - Migliorato il parsing del codice generato con GTBox (non sbaglia pi∙ su
  84.     alcuni valori e non genera pi∙ costanti tipo "#0")
  85.   - Ricorsivitα migliorata e meglio funzionante.
  86.  
  87. NOTA: questa Φ la prima vera versione che viene distribuita in PD. Le altre
  88.       sono sempre state date solo a pochi "iniziati". Spero che questo
  89.       "allargamento" ne aumenti l'utilizzo e possa aiutarmi a migliorare
  90.       GTConv sempre di pi∙.
  91.  
  92.  
  93. ISTRUZIONI PER L'USO:
  94. ---------------------
  95. Essendo  un  convertitore,  GTConv  ha  bisogno  di  un  codice  da convertire.
  96. Attualmente  GTConv  converte  in  codice  Blitz  II  la  versione C del codice
  97. generato  da  GTBox.   Quindi per utilizzare correttamente GTConv dovrete avere
  98. GTBox (ma chi non ce l'ha?  :) e fargli generare un sorgente C premendo Amiga-C
  99. oppure scegliendo "Generate C Source" dal menu.
  100.  
  101. NOTA: Dal momento che GTConv legge "pi∙ volte" lo stesso codice che viene
  102.       generato da GTBox, Φ consigliabile salvare il sorgente C in Ram Disk.
  103.       Questo velocizza notevolmente il processo di conversione.
  104.  
  105. NOTA2: GTConv ha bisogno che siano presenti nella stessa directory (ad es.
  106.        Ram Disk) sia il ".c" che il ".h" generati da GTBox. Questo non
  107.        dovrebbe essere un problema, dal momento che GTBox salva i due files
  108.        assieme. Ma state attenti a NON CANCELLARE IL ".H" ! Altrimenti
  109.        GTConv non genererα del codice appropriato.
  110.  
  111. NOTA3: Anche se GTBox permette di definire pi∙ di una singola finestra
  112.        alla volta, GTConv non lo permette. Dovrete quindi generare delle
  113.        interfacce a "singola finestra" e convertirle con GTConv.
  114.        Se avete bisogno di pi∙ GTList differenti e di pi∙ Window con gadgets
  115.        GadTools contemporaneamente sullo schermo, dovrete creare pi∙
  116.        sorgenti C e convertirli uno per volta.
  117.  
  118. Se  avete  un  sorgente  C  generato  con  GTBox,  avete giα quasi terminato di
  119. utilizzare anche GTConv.
  120. La finestra di GTConv pu≥ essere divisa idealmente in tre parti principali:
  121.  
  122.   1 - Zona "Azioni"
  123.   2 - Zona "Settaggi"
  124.   3 - Zona "Settaggi Avanzati" (che non vuol dire rimanenti ma "Per i Pi∙
  125.                                 esperti... :)
  126.  
  127. AZIONI:
  128. -------
  129. Le operazioni possibili nella zona "Azioni" sono:
  130.  
  131. CONVERT: Φ l'operazione principale, apre un requester e richiede un sorgente
  132.          C generato con GTBox per iniziare la conversione vera e propria.
  133.          Al termine della conversione verrα aperto un nuovo requester che
  134.          richiede l'inserimento del nome del file di DESTINAZIONE, il file,
  135.          cioΦ, dove GTConv scriverα il suo codice Blitz II.
  136. ABOUT:   scrive un messaggio di (C)Copyright.
  137. QUIT:    esce da GTConv.
  138.  
  139. SETTAGGI:
  140. ---------
  141. Questa  zona  ha  dei  Check  Gadgets  e degli Integer Gadgets, i gadgets Check
  142. possono  essere  selezionati  (attivi)  o  deselezionati, nel caso siano attivi
  143. influenzeranno  il  codice  generato  da GTConv.  Ecco come funzionano e a cosa
  144. servono.  I valori tra parentesi rappresentano i default.
  145.  
  146. Add Gad Handler (CHECK): (OFF)
  147.   se selezionato, aggiunge una breve routine per la gestione dei gadgets.
  148.   Utile per iniziare velocemente a creare i vostri programmi.
  149.  
  150. Add Comments (CHECK):   (OFF)
  151.   se selezionato, aggiunge dei commenti al codice generato per facilitarne
  152.   la lettura ai programmatori meno esperti di Blitz II.
  153.  
  154. Show Operations (CHECK): (ON)
  155.   se selezionato, mostra nella zona di GTConv chiamata "Operations" dei
  156.   messaggi riguardo alle operazioni che GTConv sta svolgendo.
  157.  
  158. Gads And Bevs Only: (OFF)
  159.   se selezioanto, genera solo il codice per i gadgets e i BevelBoxes, senza
  160.   generare null'altro codice. Utile nel caso si sia modificata l'interfaccia
  161.   con GTBox, ma i settaggi della Window e dello schermo siano rimasti
  162.   invariati.
  163.  
  164. GTList Number (INT): (0)
  165.   questo gadget numerico contiene il valore della GTList che verrα utilizzata
  166.   per creare il codice.
  167.  
  168. Window Number (INT): (0)
  169.   questo gadget numerico contiene il valore della Window che verrα utilizzata
  170.   per creare il codice e che ospiterα i gadgets creati.
  171.  
  172. SETTAGGI AVANZATI:
  173. ------------------
  174. Modificate  questi  valori nel caso che la vostra interfaccia abbia pi∙ Bevels,
  175. Testi  o  Menu  di  quanti  sono  stati settati per default.  I tre gadget sono
  176. Integer e contengono i valori di default del programma.  Normalmente, comunque,
  177. non dovrete preoccuparvi di modificare questi settaggi.
  178.  
  179. CONCLUSIONI:
  180. ------------
  181. Spero  che  GTConv  sia  utile e che possiate sfruttarlo il pi∙ possibile.  Nel
  182. caso  ci  siano  dei  "bugs"  o  delle  anomalie  di  conversione,  per  favore
  183. contattatemi  e  fatemi  sapere  quali errori o anomalie avete riscontrato, nel
  184. caso  non  converta  perfettamente  alcuni  tipi di gadgets, speditemi un file,
  185. anche in formato ".gui", col quale io possa verificare l'anomalia.
  186.  
  187. RINGRAZIAMENTI E SALUTI:
  188. ------------------------
  189. Vorrei ringraziare le seguenti persone per le loro creazioni:
  190.  
  191.    Nico Francois : Per la sua eccezionale "reqtools.library".
  192.    Neil O'Rurke  : Per la sua implementazione in Blitz II della ReqTools.
  193.   Commodore Amiga: Per la "gadtools.library" e per il computer pi∙ bello.
  194. Jan van der Baard: Per aver creato GadToolsBox. Un programma splendido.
  195.  
  196. E salutare queste altre:
  197.  
  198.   Michele Puccini (ClassX) : per aver sempre apprezzato i miei programmi e
  199.                              per avermi sempre segnalato anomalie di GTConv.
  200.                              (Oltre, naturalmente a tutti i consigli che mi
  201.                              dα di programmazione....)
  202.   Kronos The Wizard : per avermi sempre fatto divertire da matti quando
  203.                       scrivo codice con lui.
  204.   Stefano Clemente : per aver sempre caldeggiato la creazione di GTConv e
  205.                      anche di tutti i miei programmi.
  206.   Commando Unlimited: per la sua splendida grafica che spesso uso, e per
  207.                       il suo menefreghismo totale per i miei programmi che
  208.                       non siano giochi.
  209.   Fabio Milos: per aver sempre adorato il mio Quadranoid!
  210.  
  211. AUTORE:
  212. -------
  213. GTConv Φ scritto da Fabio Rotondo.
  214. L'autore pu≥ essere raggiunto cos∞:
  215.  
  216. FABIO ROTONDO
  217. C.so Vercelli 9
  218. 28100 Novara
  219. ITALY
  220. Tel. 0321 - 459676
  221.